This option is obsolete by -wadinclude and is only left in to retain some backwards compatibility.
}
CheckBox = Entities Only
{
Param = -onlyents
Hint = Do an entity update from .map to .bsp.
This option will take the entities from the .map file and update them into the bsp file. For the most part, entities can only be edited. Adding or removing any can reorder the other entities which frequently break brush based entities, especially triggers.
}
CheckBox = GL View
{
Param = -glview
Hint = Create <mapname>.gl file.
Creates a <mapname>.gl file, which contains the number of planes, the number of points in each plane, the points used to define each plane, and the total light on that plane.
}
Spaces = 7
EditBox = Additional Parameters
{
Type = string
Width = 3
Hint = Add additional parameters here as you would a command line.
}
}
//
// BSP
//
Group = BSP
{
Name = Binary Space Partition
RequireEXE = true
EXEFilter = QBSP (qbps2.exe)|qbsp2.exe
CheckBox = Leak Only
{
Param = -leakonly
Hint = Run BSP only enough to check for leaks.
If you already know a map has a leak, this is a good option to just save some time in hlbsp and just generate the pts file.
}
CheckBox = Not T-Junction
{
Param = -notjunc
Hint = Don't break edges on t-junctions (not for final runs).
This is a development/debugging option that should not be set in normal use.
}
EditBox = Subdivide
{
Param = -subdivide
Type = Float
Default = 240
Min = 64
Max = 240
Hint = Sets the face subdivide size.
Faces in Half-life are subdivided by this value (in units). The default and maximum are both 240, and it should never need to be set lower (as it just increases r_speeds).
}
Spaces = 7
EditBox = Additional Parameters
{
Type = string
Width = 3
Hint = Add additional parameters here as you would a command line.
}
}
//
// VIS
//
Group = VIS
{
Name = Visibility Index Set
RequireEXE = true
EXEFilter = VIS (vis.exe)|vis.exe
CheckBox = Fast
{
Param = -fast
Bold = true
Hint = Fast vis.
A fast vis is handy for running around in a developed map without dropping polygons. However, r_speeds will usually be pretty bad, as well as epoly counts. The map can still be lit with hlrad, however its quality and compile time will both suffer as a result. Maps should regularly be compiled without fast vis, as fast vis can mask a sudden increase in normal vis compile time.
}
Spaces = 9
EditBox = Additional Parameters
{
Type = string
Width = 3
Hint = Add additional parameters here as you would a command line.
}
}
//
// RAD
//
Group = RAD
{
Name = Radiosity
RequireEXE = true
EXEFilter = QRAD (qrad.exe)|qrad.exe
CheckBox = Extra
{
Param = -extra
Bold = true
Hint = Turns on 9 point oversampling for lighting, making it look much better.
}
CheckBox = No Texture Scale
{
Param = -notexscale
Hint = Do not scale radiosity patches with texture scale.
By default, hlrad will take the texture scale and apply it to the chopping grid which is projected onto it. This option turns that off, and almost always increases the number of patches in a map as most maps have many walls scaled up to 2 and 3.
}
CheckBox = Dump Light Patches
{
Param = -dump
Hint = Dumps light patches to a file for hlrad debugging info This is a developer option for zhlt, to dump out the patch data generated by the chopping/subdividing and make sure it looks alright.
}
CheckBox = Incremental
{
Param = -inc
Hint = Use or create an incremental transfer list file.
This is a handy option for tweaking lighting, especially on slow or lower memory machines. BuildVisLeafs, MakeScales, and SwapTransfers can be skipped entirely on subsequent runs of hlrad. Note that geometry must not change, but lighting can.
}
Spaces = 6
EditBox = Additional Parameters
{
Type = string
Width = 3
Hint = Add additional parameters here as you would a command line.
}
EditBox = Bounce
{
Param = -bounce
Bold = True
Type = Int
Default = 1
Min = 0
Hint = Set number of radiosity bounces.
This option sets the number of times light bounces in the radiosity pass. By the time the code gets to this point, all the data is precomputed, and extra bounces are very fast. It will make the shadows less harsh using more bounces, but can help light up dark areas much more naturally.
}
EditBox = Smooth
{
Param = -smooth
Bold = True
Type = Float
Default = 50
Min = 0
Max = 180
Hint = Set smoothing threshold for blending (in degrees).
By default hlrad uses Phong shading on all faces. If the angle between two edges is less than this value, it will be shaded with the Phong smoothing code, otherwise it won't.
}
EditBox = Chop
{
Param = -chop
Type = Float
Default = 64
Min = 1
Hint = Set radiosity patch size for normal textures.
Each face in the world has a grid projected onto it, and chopped up into a rather coarse set of sample points. These points are patches, and are what hlrad uses to do the bounced lighting calculations. A higher chop sacrifices quality for both speed and memory consumption of hlrad. A lower chop increases the quality at the expense of speed and memory usage.
}
EditBox = Coring
{
Param = -coring
Type = Float
Default = 1
Min = 0
Hint = Set lighting threshold before blackness on switchable light surfaces.
This value controls how much light it takes before a surface will be lit with a non-black value.
}
EditBox = Max Light
{
Param = -maxlight
Type = Float
Default = 2
Min = 0
Max = 2
Hint = Overexpose textures.
Allows for the overexposure of textures for more realistic lighting. Less than 2 produces duller lighting, but the textures don't "blow out" as much.
}
EditBox = Scale
{
Param = -scale
Type = Float
Default = 1
Min = 0
Hint = Set global light scaling value.
This option scales the final light values right after the direct lighting layer is added to the radiosity bounced lighting layer. Low values make the world darker, higher values make it brighter.
}
EditBox = Gamma
{
Param = -gamma
Type = Float
Default = 0.5
Min = 0
Hint = Set global gamma value.
This option also occurs after the direct and radiosity layers are added together, and a global gamma correction is calculated and applied to the lighting before it is finalized.
}
EditBox = Sky
{
Param = -sky
Type = Float
Default = 1
Min = 0
Hint = Set ambient sunlight contribution in the shade outside.
Many faces have line of sight to sky, but fall in the shadow of some other object. This option affects how much of the normal sky lighting is put into the shadows. A setting of '1' (the default) will result in a full hemisphere of the sky contributing about 1/4 of the direct component. Set to '0' for direct lighting only. Set to a value greater than '1' for a more diffuse (cloudy, overcast) sky appearance.
}
Spaces = 3
ComboBox = Messages
{
Default = Normal
Options = Terse,-terse|Normal,|Verbose,-verbose
Hint = Set the message mode to run QRAD in.
Terse runs with the minimum amount of information output during compiling, normal runs without any special messages and verbose runs with the maximum amount of information output during compiling. Many of the tools have 'minor warnings' and informative messages which are displayed when verbose mode is set.
}
ColorBox = Ambient Light
{
Param = -ambient
Default = 0 0 0
Hint = Set ambient world light.
This option sets a minimum light value to every face so that nothing comes out pitch black.
The .rad file will be used in addition to the defaults of lights.rad and mapname.rad.
}
}
Group = Shared
{
CheckBox = Verbose
{
Param = -v
Groups = CSG,BSP,VIS
Hint = Compile with verbose messages.
Many of the tools have 'minor warnings' and informative messages which are displayed when verbose mode is set.
}
EditBox = Threads
{
Param = -threads
Groups = CSG,BSP,VIS,RAD
Type = Int
Default = 1
Min = 1
Hint = Manually specify the number of threads to run.
This option is generally only necessary on the non-windows versions of the tools, where there is not a standard way to detect the number of processors in the system and auto-set the value. It can be manually set on windows machines, primarily if you wish to use fewer threads than processors.
